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This is the first issue of Berkeley Computing, Infor- 
mation Systems and Technology’s (IST’s) new period- 
ical incorporating the Bulletin and Quarterly. By 
consolidating periodicals, we expect to be able to 
publish a comparable amount of information more 
efficiently, in fewer issues per year. As before, we 
will be covering IST services such as the Campus 
Network; the shared VM/CMS, UNIX, and Cray 
UNICOS systems; administrative computing; worksta- 
tions and microcomputers; software site licensing 
and distribution; user consulting; training opportuni- 
ties; and online information resources; as well as 
other news of interest to campus Computer users. 

We would like to hear from you. If you have 
comments about Berkeley Computing or other IST 
publications, send electronic mail to avante at garnet 
or call me at 642-7582. O Kalle Nemvalts . 


Cray Supercomputers 


Cray Workshops in January 


Cray Research, Inc., and Central Computing Services 
will offer two workshops in January: 


Parallel Processing Workshop. Dr. David Shirley of 
Cray Research, Inc., will conduct a two-day 
workshop on parallel processing techniques for Cray 
supercomputers on January 13 and 14 from 9 a.m. to 
5 p.m. Participants should have experience using 
the Cray X-MP and experience vectorizing Fortran 
programs. Participants are encouraged to come to 
the workshop with code on the X-MP that they 


would like to parallelize. No prior parallel process- 
ing experience is necessary. The class will use the 
campus’s multiprocessor X-MP for programming exer- 
cises. Enrollment in the class will be limited, and 
preference will be given to researchers with Fortran 
applications that are good candidates for parallel 
processing. 


Designing for Speed. A three-day workshop on the 
optimization of Fortran and C programs on Cray 
Research computer systems will be offered January 
15 through 17. The workshop is open to all 
members of the campus community with a current 
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or future need for supercomputing. The only prere- 
quisite is a working knowledge of either C or For- 
tran, and a minimal reading knowledge of Fortran. 


To register for either workshop or to obtain more 
information, call the Cray consultant at 643-7633, 
or send mail to jerry at violet. O 


Commands in /usr/unsupported 


The /usr/unsupported directory on the Shared UNIX 
VAXes Garnet and Violet contains software that the 
Shared UNIX Services Group thinks would be useful 
to users but for which it does not have the resources 
to provide the usual support. Individual commands 
are in the directory /usr/unsupported/bin. Most 
packages of commands are in directories with the 
name /usr/unsupported/package. 

Some of the products in /usr/unsupported are: 


elm A flexible mail front-end. 


emacs and jove 
Full-screen text editors. 


gcc GNUC. 
ispell An interactive spelling checker. 


Macintosh programs 
macput and macget for MacTerminal xmodem 
file transfers; mw and layers for multi-window 
terminal sessions; macps for printing Macin- 
tosh PostScript files; mevert, macbin, and unsit 
for file format conversion. 


mh A powerful mail user interface that has a loyal 


following. 
perl An interpreted language that contains features 
of sh, csh, awk, and sed, and gives a lot of the 
functionality of the C programming language. 
shar “Shell archive,” which combines multiple 


ASCII files into one single ASCII file, with inter- 
nal checksums, suitable for convenient 
transfer by electronic mail. The created file is 
unbundled by invoking it as an sh script. 


tex TEX, a text formatting package created by 
Donald Knuth of Stanford University. 


window 
A windowing program for ASCII terminals. 
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X11 The X Window System from MIT (Version 11, 
Release 4). Note: On Garnet, X11 is in 
/usr/ccs/X11 instead of 
/usr/unsupported/X11. 

zmodem 


A file transfer protocol that is faster and more 
reliable than xmodem. (The basic commands 
are rz and sz.) 


How to Access These Commands 

There are two ways to access commands in UNIX. 
One is by pathname (either the full pathname of the 
file or the pathname relative to your current direc- 
tory). The other is by searchpath. The first way is 
clumsy but works fairly well in conjunction with 
aliases when the command is not part of a package, 
for example, 


% alias perl /usr/unsupported/bin/perl 


Then just use perl to access this command. The 
second way is necessary for packages of commands 
and some individual commands that invoke other 
commands without using full pathnames. 

To access commands in /usr/unsupported/bin 
by searchpath, you need to add 
/usr/unsupported/bin to your path shell variable. 
On Garnet you do this by adding the line 


set path = ( $path /usr/unsupported/bin ) 
at the end of your .cshrc file after the line 

source /usr/skel/ccs.cshrc 

On Violet, to add /usr/unsupported to your 
searchpath, find the line in your .cshrc or .login file 
that begins with “set path =” and add 
/usr/unsupported/bin to the list. For example, if 
your .login file contains the line 

set path = ( /usr/ucb /bin /usr/bin . ) 


then change it to 


set path = ( /usr/ucb /bin /usr/bin \ 
/usr/unsupported/bin . ) 


To use a package of commands, you will need to 
add the full pathname of its bin directory to your 
searchpath. On Garnet, add a statement of the form 


set path = (/usr/unsupported/package/bin $path) 
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at the end of your .cshre file after the line 
source /usr/skel/ccs.cshrc 


On Violet, add /usr/unsupported/package/bin 
to the definition of path in your .cshrc or .login 
file—for example, 


set path = (/usr/unsupported/package/bin \ 
/usr/ucb /bin /usr/bin .) 


See help searchpath for more information. 


Manual Pages 

On Garnet, the MANPATH environment variable 
should be implicitly set through the command 
source /usr/skel/ccs.cshrc at the end of your .cshrce 
file. Manual page directories for packages exist as 
/usr/share/man/package on Garnet, where package 
might be something like X11 or tex. To add sucha 
directory to your MANPATH, put the line 


setenv MANPATH = $MANPATH: 
/usr/share/man/package 


(typed on a single line with no spaces after the 
colon) after the line source /usr/skel/ccs.cshre in 
your .cshrc file. 

On Violet, the man command finds the manual 
pages for most commands in /usr/unsupported/bin 
automatically. If you want to see the manual pages 
for certain packages of commands, you will have to 
set the MANPATH environment variable and include 
on it the appropriate directory names. Here is a 
generic example (this example must be typed on a 
single line with no spaces after the colon), 


setenv MANPATH /usr/man: 
/usr/unsupported/package/man 


where package might be something like X11 or tex. 
(If you set MANPATH, you must include /usr/man. 
To set MANPATH permanently, add the setenv 
MANPATH command to your .cshrc file. See help 
man for more details on setting your MANPATH.) 


Support 

There are two types of software support: mainte- 
nance (installation, updating, and fixing bugs) and 
consulting (advice, instruction, and documentation). 
Maintenance depends on the product; in some cases 
there is an active supporter who fixes bugs and 
makes new versions available. In other cases there 
may be no supporter. There is very little consulting 


Berkeley Page 3 


Computing 


available for products in /usr/unsupported, but don’t 
hesitate to ask consultants about the status of a 
specific product or availability of hardcopy docu- 
mentation. O Fran Rizzardi. 


Command Line Editing and Filename 
Completion in the ULTRIX 4.2 C Shell 


Since the conversion of Garnet to ULTRIX Version 
4.2, the new default C shell (csh) includes command 
and filename completion and command line editing. 


Command and Filename Completion 

This csh recognizes partial alias names, command 
names (including built-in csh commands), and 
filenames, and will expand them to their full names. 
This feature is usually referred to as command and 
filename completion. Command and filename com- 
pletion perform a function similar to the C shell wild- 
card characters * and ?. They can help you to 
minimize typing and frustration by completing a 
command name or filename once you have typed in 
enough characters to identify it uniquely. To com- 
plete a file or command name, just 


1. Type enough characters at the prompt to make 
your input to the system unique. 


2. Press the Escape key (denoted by ‘“<ESC>’’ 
below).* 


For example, if your subdirectory contains the fol- 
lowing files, 


% ls 
file1 food 
file2 thesis 


and you type, 
% Is -l fo<ESC> 


you'll get this result: 
% Is -I food 


* If you are logged in through the port selector using 7 
data bits and even parity, command line editing may not 
work correctly. This is because the C shell does not strip 
the parity bit when interpreting edit commands and does not 
generate a parity bit on output to your terminal. Thus, on 
some terminals you will see garbage characters after pressing 
<ESC> and you may not be able to manipulate your 
command list. You can try setting your terminal or emulator 
software to 8 data bits and no parity or 7 data bits and space 
parity. Refer to help convert ultrix4.2_bugs for other ideas. 
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The C shell has completed the filename for you. 
Your cursor remains at the end of the command line 
so that you can continue to type in your command 
or press the Return key to execute the command. 
You can also use this method to complete the name 
of acommand. For example, 


% apr<ESC> 
produces 
% apropos 


If you have not typed in enough characters to iden- 
tify a command or filename uniquely, the terminal 
signals you with a beep. You can type in one or 
more additional characters and try using the Escape 
key again, or you can enter a Control-D (hold down 
the key marked “Control” or “CTRL” and simultane- 
ously press the D key) to get a list of commands or 
filenames that begin with those characters, so that 
you can choose one. For example, 


% Is -l fi<ESC> 
results in 
% Is -I file 


and the terminal beeps to indicate that there is more 
than one filename that begins with these characters. 
If you enter a Control-D, you'll see a list of all the 
files that begin with “file”: 


% Is -l file<CTRL-D> 
file1 file2 


After listing the files, the prompt and the partially 
completed command will appear on the next line. 
At this point, you can type in either a 1 or 2 fol- 
lowed by Return to list the desired file. 

This feature can be quite useful, particularly if 
you often make typos. 


Command Line Editing 
The C shell lets you edit previous commands using 
a subset of vi or emacs commands. This offers 
functionality similar to using history substitution 
but lets you interactively edit the command line 
instead of using clumsy history modifiers. For a 
complete list of the available command line editing 
commands, see the section of man csh entitled 
“Editing Interface.” 

You can choose your editing environment by 
defining the new environment variable CSHEDIT as 


November-December 1991 University of California 
Volume 1, Number 1 at Berkeley 


either vi or emacs. If CSHEDIT is not defined, csh 
looks at the value of the EDITOR environment vari- 
able. If neither the CSHEDIT nor EDITOR are defined, 
then your command line editor defaults to vi. Type 
help cshell variables for more information on 
environment variables. 

New accounts on Garnet are set up so that your 
25 most recent commands are automatically saved in 
what is called a history list. You can edit the com- 
mands stored in your history list by pressing Escape 
at the C shell prompt (%), or by using the new his- 
tory modifier :v. For example, suppose that your last 
11 commands look like this: 


46 Is /usr/ucb | more 
47 man 7 environ 
48 lIs /usr/ucb/bi* 
49 help convert 
50 Is 

51 cp file1 file3 

52 diff file2 food 
53 help searchpath 
54 cat food 

55 mail 

56 vi thesis 


If you enter an Escape at the C shell prompt, you'll 
get your most recent command: 


% <ESC> 
vi thesis 


with your cursor located on the “v” in vi. You can 
now use regular vi commands on this line. For 
example, to change this command to 


% cp thesis thesis.bak 


you could type cw followed by the keystrokes 
cp<ESC> . This will change the command to 


cp thesis 


Next, you can add a word to the end of the line 
using the A command and type in thesis.bak<ESC>. 
Your command line will now look like this: 


cp thesis thesis.bak 


Just press Return to execute the edited command. 
The Escape key is handy when you want to edit 
your most recent command. If you want to edit an 
earlier command, you can use the :v history modi- 
fier. For example, if you wanted to edit the last diff 
command that you gave, you can do it the usual way 
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(i.e., !diff) and follow it by :v. The :v recalls com- 
mands from your history list and puts you in edit 
mode. For example, the following invokes 
command line edit mode for the most recent 

diff command line: 


% tdiff:v 


When you press the Escape key as the first character 
on a command line, it is equivalent to typing 


% ttv 


This calls up your most recent command and places 
you in command line edit mode. 

Another useful editing feature is scrolling through 
your history list. After you have entered command 
line edit mode by typing either !commana:v or 
<ESC>, you can use k (or the up-arrow) and j (or the 
down-arrow) to move up and down your history list. 
You can also edit any command line in that list. 

When you are in edit mode, all control charac- 
ters are displayed as space characters. Additional 
control characters cannot be inserted. Existing con- 
trol characters are preserved. For more details on 
these and other C shell features, see man csh and 
help cshell on Garnet. O Michele Tomkin. 


Workstations and Microcomputers 


Workstation Support Services 
Consulting: 264 Evans — 642-8899 


Editor's note: The Workstation Consulting office in 
264 Evans Hall (642-8899, drmicro at garnet) is open 
from 10 a.m. to 12 noon and 2 to 4 p.m. weekdays. 
Workstation graphics are by Ed Moy. 


Ask Dr. Micro: Running System 7 on 
2 MB Macintoshes 


“Ask Dr. Micro” provides answers to workstation and 
microcomputer questions of general interest. Readers 
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can submit questions by sending electronic mail to 
drmicro at garnet, by calling 
642-8899, or by visiting Worksta- 
tion Consulting in 264 Evans Hall. 
The Workstation Consulting staff 
will reply to questions as quickly 
as possible. Dr. Micro had help from Aron Roberts in 
answering this question. 


DEAR DR. MICRO: I just bought a Macintosh LC. 
When I try to run Microsoft Word, I get an error 
message saying that I don’t have enough memory. 
I am running System 7, and I have 2 MB of RAM. 
Why does this happen and what can I do about it? 
As it is right now, | am unable to get any work 
done. — Unable to Compute 


DEAR UNABLE: As you have discovered, 2 MB (mega- 
bytes) of random access memory (RAM) is not 
enough to use System 7 effectively. With only 2 MB, 
many of your application programs will not have 
sufficient RAM to run. In addition, under 

some circumstances, you may be unable to print 
your documents. 

On many Macintosh models with only 2 MB, a 
factory installation of System 7 leaves less than 1 MB 
of available RAM in which applications—such as 
word processing, spreadsheet, and drawing 
programs—can run. At the same time, many popular 
application programs have been configured to 
require 1 MB or more of RAM. PageMaker 4.0, 
Microsoft Excel 3.0, and HyperCard 2.1, for instance, 
are preset to require 1.5 MB of RAM, and Microsoft 
Word 4.0 is preset to require 1 MB (although all but 
PageMaker can actually operate in less memory). 

In many of its publications, Apple suggests that 
any Macintosh Plus or later computer with 2 MB of 
RAM and a hard disk drive can successfully run Sys- 
tem 7. However, as noted in the article ‘Setting 
Course for System 7” below, the Workstation 
Software Support Group recommends that Macin- 
toshes have at least 4 MB of RAM in order to perform 
satisfactorily when running System 7. 


Add More Memory to Your Macintosh 

The simplest and best way to permit your Macintosh 
to take full advantage of System 7 is to add memory 
to bring your total to at least 4 MB of RAM. 

A handout, Adding Memory to Your Macintosh 
(MIC 2.4.19), describes in considerable detail how to 
add memory to your Macintosh computer. This 
handout is available from the Workstation 
Consulting office. 
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Use Memory More Efficiently 

Until you can add more memory to your computer, 
the following suggestions can help you use memory 
more efficiently under System 7. Additional sugges- 
tions for using memory more efficiently with both 
System 6 and System 7 are available from the Work- 
station Consulting office as the handout Maximizing 
Your Macintosh’s Memory (MIC 2.4.20). 


Reduce the amount of memory that you give to your 
programs. Under System 7, when you launch a pro- 
gram, it uses a fixed-size block, or “partition,” of 
your Macintosh’s memory. Until you quit that pro- 
gram, that memory is no longer available to other 
programs. Although many programs are preset to use 
large memory blocks when they are launched, some 
will still run successfully if they are given less 
memory. 

Using System 7, you can reduce a program’s 
memory allocation by selecting an application 
program’s icon and choosing ‘‘Get Info’’ from the 
File menu. You will see an information dialog box 
that includes two values for “Memory”: “Suggested 
size” and “Current size”. You can reduce the 
memory that will be used by this program by typing 
a new value in the editable text field next to 
“Current size”, but you should not make this value 
smaller than the “Suggested size”. After closing the 
“Get Info’’ dialog box, try running the program again 
in the new, smaller memory partition. 

If you have difficulty setting the memory alloca- 
tion for a program, the program may be in use or 
locked. If the program is currently running, try quit- 
ting the program. If the Locked box in the “Get 
Info” dialog box is checked, you can click in this box 
to remove the checkmark. Then try setting the 
current memory size again. 

The problem with reducing the amount of 
memory that you give to programs is that some pro- 
grams will no longer allow you to access certain 
features and, in some cases, will behave unpredict- 
ably when given less memory than their publishers 
have specified. For instance, reducing HyperCard’s 
memory may mean that you will no longer have 
access to the program’s Painting tools. Reducing the 
memory allocation for Microsoft Word may mean 
that you will not be able to Undo some operations. 


Remove or temporarily disable programs that load 
into memory at startup time. System extensions 
(formerly known as startup documents or INITs) and 
Control Panel documents (cdevs) that add function- 
ality to your system, such as screen savers, programs 
that play sounds, and anti-virus software, may 
require a great deal of memory. 


University of California 
at Berkeley 


November-December 1991 
Volume 1, Number 1 


Under System 7, you can temporarily disable all 
of these items by holding down the Shift key when 
you start up your Macintosh. When you do this, 
you will see the message “Extensions off” below the 
usual “Welcome to Macintosh” banner. 

You can permanently prevent these system 
extension and control panels from loading into 
memory when you start your Macintosh by removing 
them from your System Folder and the Extensions 
and Control Panels subfolders within the System 
Folder. You should remove any of these items that 
you do not use regularly. (We recommend, of 
course, that you retain your anti-virus software.) 
Alternately, you can use a program that allows you 
to selectively enable and disable system extensions 
and control panels, such as the free program from 
Apple called “Extensions Manager”. You can find 
this program on the Cornucopia file server in the 
Vanishing Point AppleTalk zone, on “The Depot” 
disk, in the “System Software”, then “System 7.0”, 
then “Apple System 7 utilities” folders. For more 
information on accessing Cornucopia, see the hand- 
out Software for your Macintosh via the Cornucopia 
File Server (MIC 2.4.10), available from Workstation 
Consulting. 


Turn on virtual memory. With some Macintosh 
models, System 7 allows you to use hard disk space 
as additional RAM, or “virtual memory,” which can 
increase the total amount of memory available for 
running programs. To take advantage of virtual 
memory, open the “Control Panels” folder within 
the System Folder, and then open the “Memory” 
control panel. Click in the “On” button next to 
“Virtual Memory”, select a disk on which to create 
the virtual memory file, and then set the total 
memory size that you would like to have available. 
When you next restart your Macintosh, you will have 
access to the amount of memory you specified. 

Virtual memory (using disk space as RAM) is 
dramatically slower than physical memory (memory 
chips inside your computer). On a 2 MB Macintosh, 
using virtual memory will require that information be 
read from and written to your hard disk frequently, 
and your Macintosh’s performance will be very slug- 
gish. You will find virtual memory to be much more 
useful if you have at least 3 to 4 MB of physical 
memory. 

You should also note that some programs are 
incompatible with virtual memory. Apple’s 
“Compatibility Checker” HyperCard stack, which is 
included on the ‘‘Before You Install” disk that comes 
with System 7 Upgrade Kits and is also available 
from Workstation Consulting, can tell you which 
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programs might not work properly when virtual 
memory is turned on. 


Turn off File Sharing. System 7 lets you share your 
hard disk (or selected folders and their subfolders) 
with other computer users on a network. However, 
the File Sharing option requires between 260 and 
300 KB (kilobytes) of RAM. If you are in need of addi- 
tional usable memory, you might want to disable File 
Sharing temporarily. To do this, open the Control 
Panels folder within the System Folder, and then ; 
open the “Sharing Setup” control panel. If the but- 
ton next to the File Sharing option reads “Stop”, 
indicating that File Sharing has been previously 
turned on, click on this button to turn it off. 


Reduce the size of your disk cache. A disk cache is 
an area of memory set aside to hold data that have 
recently been read from a disk to improve your 
computer’s performance when a program requires 
repeated access to those data. Under System 7, you 
can reduce the amount of memory required by the 
disk cache by opening the “Control Panels” folder 
within the System Folder, and then opening the 
“Memory” control panel. You can click the down 
arrow next to the “Cache Size” panel until the size 
of the disk cache is as low as it will go (usually 

16 KB). 


Reduce the number of colors or gray scales, The 
Macintosh LC, Ilsi, and IIci have a built-in video port 
into which you can plug an external monitor (display 
screen). On the Macintosh IIsi and IIci, a portion of 
system memory is set aside as video memory to 
display images on the monitor. The more colors and 
gray scales that you display, the more memory is 
required. If you are using 8-bit video (up to 256 
colors or shades of gray) on a Ilsi or IIci, you may be 
using up to 280 KB of RAM. You can reduce the 
memory requirement for built-in video by opening 
the “Monitors” control panel document in the ‘‘Con- 
trol Panels’’ folder within the System Folder and then 
selecting “Black & White” from the scrolling list, or 
by adding a video card to your computer and plug- 
ging your monitor into it. 


Turn off background printing. Many Apple printers 
(various LaserWriter models and the StyleWriter) 
come with software that lets you print in the back- 
ground while you are still working in other programs 
on your Macintosh. If you are running out of 
memory while trying to print, you can turn off back- 
ground printing by selecting the Chooser from the 
Apple menu, clicking on the icon for your printer, 
and clicking on the “Off” button next to the label 
“Background Printing”. The next time that you 
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print, you will have to wait for printing to finish 
before you can use your Macintosh for other work, 
but you will also have more memory for your appli- 
cations.O Dr. Micro, drmicro at garnet. 


Setting Course for System 7 


It has been several months since System 7, Apple’s 
latest and greatest version of its 
Saar system software, became avail- 
sz, able. New Macintosh systems 
Cr with the appropriate hardware 
configurations are now being 
shipped with System 7 prein- 
stalled. It may be time to 
consider upgrading your own Macintosh to System 7. 

Although System 7 offers many new features and 
improves on the classic Macintosh interface, we at 
the Workstation Software Support Group (WSSG) and 
others have suggested caution when considering the 
upgrade to System 7, due primarily to the concern 
about known and possibly unknown incompatibilities 
with other Macintosh software. Over the last few 
months, Macintosh support groups like ours have 
been testing System 7, and through collective sharing 
of information, we now have a much better feel for 
the support issues involved with upgrading to Sys- 
tem 7. 

In general, System 7 seems compatible with most 
mainline applications, especially the latest versions. 
Many new versions of applications have come out 
recently, offering not only System 7 compatibility (or 
“System 7 friendliness’), but also “System 7 sawvi- 
ness” (actually using some of the new System 7 
features, such as Publish and Subscribe, or Balloon 
Help). 

Older versions of software may be only slightly 
incompatible, perhaps showing only cosmetic prob- 
lems, or can be totally incompatible and actually not 
work or cause system crashes. Many system exten- 
sions (previously called startup documents or INITs) 
and control panels (cdevs)—these are pieces of 
software that you put into the System Folder to add 
various functionality to your Mac—may have similar 
problems. Some software may cause problems only 
if virtual memory or 32-bit addressing modes are 
turned on. And, as usual, game programs tend to be 
the worst in terms of compatibility, since they so 
often violate Apple’s recommendations for Macin- 
tosh programming. There is no better time to con- 
sider upgrading to the latest versions of software 
than when you upgrade to System 7. 

There is a lot of information now available con- 
cerning software compatibility, some of which has 
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been collected and stored on our AppleShare file 
server, Cornucopia (in the “Vanishing Point” 
AppleTalk zone), on “The Depot” disk, in the “Sys- 
tem 7” folder (within the “System software” folder). 
Other information is available from electronic bul- 
letin board systems, user groups (like our friends at 
BMUG, the Berkeley Macintosh User Group), and 
from the vendors themselves. 


WSSG-Supported Software 

By the time you read this, new versions of many 
WSSG-supported applications will be available. On 
Cornucopia, MacTCP 1.1 is. fully compatible with Sys- 
tem 7. Previous versions caused problems when vir- 
tual memory was turned on and were installed in a 
somewhat non-standard way. NCSA Telnet Version 
2.4.02 (or later) and tn3270 2.3d26 (or later) add 
some new features and fix various bugs in the previ- 
ous versions, such as only beeping when the user 
selected something in the Apple Menu under System 
7. (Although the latest version of MacKermit has the 
same Apple Menu bug as these programs, this can 
be easily gotten around by bringing another applica- 
tion to the front [such as the Finder] and using the 
Apple Menu there.) 

For users of AppleShare file serving and Laser- 
Writer print spooling from a UNIX system, the 
Columbia AppleTalk Package (CAP) Version 6.0 fixes 
several System 7 incompatibility problems. Most 
WSSG-supported UNIX installations should already be 
upgraded to CAP 6.0 by the time you read this. 


Hardware Considerations 
Although System 7 is advertised to work within 2 
megabytes (MB) of RAM, we suggest you use more 
(see “Ask Dr. Micro: Running System 7 on 2 MB 
Macintoshes” above). A reasonable minimum size 
seems to be 4 MB, especially for today’s more 
sophisticated (and thus larger) applications and to 
take advantage of having multiple applications run- 
ning simultaneously (as with MultiFinder in pre- 
System 7 systems). Of course, as with all computers, 
the more memory that you can afford, the better. 
System 7 comes with an upgraded version of the 
hard disk driver software used by all Apple hard 
disks, and most vendors of non-Apple hard disks 
now have System 7-compatible versions of their disk 
driver software. This is especially necessary when 
using virtual memory under System 7. Contact your 
non-Apple hard disk vendor for details. 
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The Feel of System 7 

There has been considerable debate over how Sys- 
tem 7 feels in terms of speed and responsiveness. 
Some users notice little or no degradation in 
response, while others may complain vehemently 
that it is too slow, especially on low-end Macin- 
toshes such as the Plus, SE, and Classic. In any case, 
System 7 is brand new, and, like all operating sys- 
tems when they first come out, may not be fully 
tuned for speed and responsiveness. Later versions 
of System 7 will inevitably be faster and more 
responsive as the tuning process continues. (There 
is already a System 7.0.1 release, although it is only a 
minor update for compatibility with the new Quadra, 
PowerBook, and Classic It models.) 


Not Ready For System 7 

The server side of some software, such as 
AppleShare 2.x and QuickMail 2.5, should not be 
run under System 7. You should continue to run 
them under System 6.0.x. 

If a LaserWriter is to be shared among a mix of 
System 6 and System 7 users, you should upgrade all 
System 6 users to the System 7 LaserWriter printer 
drivers. This may also require that System 6 users 
upgrade to System 6.0.7 or higher as recommended 
by Apple. (Conveniently, the recently released Sys- 
tem 6.0.8 is a relabeled System 6.0.7 that includes 
the System 7 printer drivers.) 


Doing the Upgrade 

On Cornucopia’s The Depot disk (as described 
above), there is a document entitled “Installation 
Checklist”. This contains a detailed, rather conserva- 
tive System 7 installation procedure that we recom- 
mend you follow when upgrading to System 7. It 
cannot be stressed too heavily that you should make 
a backup of your hard disk before you perform the 
upgrade, because if worse comes to worst and you 
find insurmountable problems with System 7, you 
can restore your hard disk to its former state. 

For those of you in charge of clusters of Macs, 
there is a folder on The Depot named “For Work- 
group Administrators” that contains details on how 
to obtain the System 7 group upgrade software from 
us, so that you can upgrade your Macs to System 7 
over an AppleTalk network. Please follow the simple 
registration instructions, and we will provide you 
with the appropriate authorization codes needed to 
access the software in this folder. 

And, as always, if you have any questions, you 
can contact us through the Workstation Consulting 
office (264 Evans Hall), by phone at 642-8899, or via 
electronic mail to drmicro at garnet. O Ed Moy. 


+ 
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Uploading and Downloading SAS 
Datasets between the PC and IBM 
3090 Mainframe 


Central Computing Services (CCS) 
and Workstation Support Ser- 
vices (WSS) have been testing a 
procedure to upload and down- 
load SAS datasets between SAS Ee 
6.06 on the IBM 3090 mainframe ==. _. 
and SAS 6.04 on a PC using 

Kermit. 


Downloading from Mainframe to PC 
These are the steps necessary to download SAS 
datasets from SAS 6.06 (mainframe) to SAS 6.04 (PC): 


1. Use Proc Xcopy to create a transport file in SAS 
6.06 on the mainframe. 


2. Download the file to the PC using Kermit with 
“set file type binary” on PC Kermit. 


3. Use Proc Copy to read the transport file in SAS 
6.04 on the PC. 


The example below demonstrates the procedure 
to create a mainframe SAS transport file and read it 
on the PC after it is downloaded using Kermit. 

Here is the sample SAS command file on the 
mainframe: 


data sasfil.usage; input size 1-4 usage 6-9; 
sizesq=size*size; 
cards; 

1290 1182 

1350 1172 

1470 1264 

1600 1493 

1710 1571 

1840 1711 

1980 1804 

2230 1840 
2400 1956 

2930 1954 


filename outtrnf ‘trncmspc trn a’; 
proc xcopy in=sasfil out=outtrnf export; 
select usage; 


Here is the sample SAS command file on the PC: 


libname trnfile sasv5xpt ’c:\trncmspc.tm’; 
libname trnout ‘c:\’; 
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proc copy in=trnfile out=trnout; 
proc contents data=trnout.usage; 


Uploading from PC to Mainframe 
These are the steps necessary to upload a SAS data 
set from SAS 6.04 (PC) to SAS 6.06 (mainframe): 


1. Use Proc Cport to create a transport file in SAS 
6.04 on the PC. 


2. Upload the file to the mainframe using Kermit 
with “set file type binary” on mainframe Kermit. 


3. Use Proc Cimport to read the transport file in 
SAS 6.06 on the mainframe. 


The example below demonstrates the syntax 
required to create a PC SAS transport file and read it 
on the mainframe after it is uploaded using Kermit. 
Here is the sample SAS command file on the PC: 


libname trnin ‘c:\’; filename trnout 
“c:\trnpccms.trn’; proc cport library=trnin 
file=trnout; 


Here is the sample SAS command file on the main- 
frame: 


filename tranfile ‘trnpccms trn a’; 
proc cimport library=trnpcfl infile=tranfile; 
proc contents data=trnpcfl.usage; 


O Nory Ison and Laura Kim. 


Site License Obtained for Macintosh 
Common Lisp 


The campus has recently obtained a site license for 
Macintosh Common Lisp, an 
interactive environment for pro- 
gramming in the Common Lisp 
language on the Apple Macintosh. 
Formerly known as Allegro Com- 
mon Lisp, Macintosh Common 
Lisp includes an incremental 
compiler that is capable of creating standalone, 
double-clickable applications (although the execut- 
able files may be very large). 

Two versions of Macintosh Common Lisp are 
currently available under this site license, Versions 
1.3.2 and 2.0b1: 


e Version 1.3.2 requires 1 MB of random access 
memory (RAM), with 2 MB or more 
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recommended, as well as 1.6 MB of disk space. 
This version also requires System 6.0 or higher, 
but is not compatible with System 7. Features of 
the 1.3.2 development environment include a 
source code stepper, object inspector, stack 
backtracer, and programmable editor. Version 
1.3.2 implements Macintosh user interface ele- 
ments as Lisp objects using Object Lisp. 


e Version 2.0b1 is the latest version of Macintosh 
Common Lisp, and requires 2.5 MB of RAM, with 
4 MB or more recommended, as well as 5 MB of 
disk space. This version requires System 6.0.4 or 
higher, and is compatible with System 7. This is 
a beta release and is known to contain bugs. 
There are currently three sets of patches distrib- 
uted with this version that fix some of these 
bugs. The final 2.0 release will be distributed 
when available. Version 2.0b1 includes improve- 
ments to the programmable Macintosh-style Lisp 
editor, the online help facility, and the interface 
toolkit for designing fully functional elements 
such as menus and dialog boxes. Version 2.0b1 
also now supports the industry-standard Com- 
mon Lisp Object System (CLOS) extension to 
Common Lisp. 


Macintosh Common Lisp is being distributed at 
no cost by the Workstation Software Support Group. 
From network-connected Macintoshes, you can 
obtain your own copies of Macintosh Common Lisp 
from the Cornucopia AppleShare file server, located 
in the “Vanishing Point” AppleTalk zone. The instal- 
lation software for each version can be found on 
“The Depot” disk, in the “Programming”, then 
“Macintosh Common Lisp” folders. There are 
instructions provided in these folders on how to 
copy this software. In particular, Version 2.0b1 is 
provided in the form of disk image files that must be 
copied onto double-density, 800 KB disks. The 
installation set for Macintosh Common Lisp Version 
1.3.2 requires two blank disks, and Version 2.0b1 
requires seven blank disks. 

For information on accessing the Cornucopia 
server, see the handout Software for your Macintosh 
via the Cornucopia File Server (MIC 2.4.10), available 
from Workstation Consulting. 

If your Macintosh is not connected to the 
Campus Network, you can obtain a copy of Macin- 
tosh Common Lisp by visiting the Workstation Con- 
sulting office. Be sure to bring two or seven blank 
double-density disks for copying Versions 1.3.2 or 
2.0b1, respectively. 
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Please note that the campus site license for 
Macintosh Common Lisp requires that the copyright 
notice and other text from the original labels for the 
disks, as distributed by Apple’s APDA unit, be affixed 
to the labels that you put on your own sets of 
Macintosh Common Lisp disks. Stick-on labels for 
your own sets of Macintosh Common Lisp disks, for 
both versions 1.3.2 and 2.0b1, are available at no 
cost from the Workstation Consulting office. 

Documentation for both versions of Macintosh 
Common Lisp is available for purchase (by campus- 
affiliated persons only) from Bear Express Copy in 
the lower plaza level of the ASUC Student Union. 
However, this documentation is not in itself 
sufficient for learning how to program in Macintosh 
Common Lisp. You will also need one or more sup- 
plementary books, such as Common Lisp: The 
Language by Guy L. Steele, Jr., (Digital Press, second 
edition, 1990). A list of these books can be found in 
the text file “Books you should have” available on 
Cornucopia’s “The Depot” disk, in the ‘‘Program- 
ming”, then “Macintosh Common Lisp” folders, or 
from the Workstation Consulting office. O 
Aron Roberts . 


DOS 5.0 Compatibility with 
Networking and Communications 
Products 


A number of communication and networking pack- 
ages supported and distributed by the Workstation 
Software Support Group have been tested with 
DOS 5.0 (both IBM PC-DOS 5.0 and Microsoft 
MS-DOS 5.0): 


MS-Kermit 3.01 (UCB 3.01a2) 

Yterm 1.3 (UCB13.01) 

Clarkson CUTCP 2.2D (UCB 2.2D-A) 

FTP Software PC/TCP 2.05 (UCB 2.05c) 
Packet Driver Collection 8.0 (UCB 8c) 
Ungermann-Bass TCP/PC 16.1 (UCB 11b) 


None of these packages required any changes to 
operate with DOS 5.0 (however, 
see below about IBM PC 
Network/LAN on DOS 5.0) 

A primary advantage of DOS 
5.0 for network users is that 
memory can be managed to 
reduce the space taken by DOS 
and the network software. This increases the space 
available to memory-hungry application programs 
such as word processors and spreadsheets. The 
advantage applies only to 286, 386, and 486 PCs that 
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have more than 640 kilobytes (KB) of memory (called 
extended memory). Modern PCs come with at least 
1 MB of memory, usually 640 KB of conventional 
memory and 384 KB of extended memory. Older PC 
ATs will not have extended memory unless an 
extended memory adapter board has been installed. 
The main benefit for 286 PCs with extended memory 
is that DOS 5.0 and its buffers can run in the High 
Memory Area (HMA, the 64 KB just above 1 mega- 
byte). Also the SMARTDRV disk caching program can 
use the rest of the extended memory. For 386 and 
486 PCs, some of the extended memory can be 
mapped into the Upper Memory Area (UMA) 
between 640 KB and 1 MB for use by device drivers 
and TSRs (terminate-and-stay-resident programs), 
such as the Ungermann-Bass TCPBIOS, PC 
Network/LAN Redirector, packet drivers, FTP 
Software PC/TCP kernel, Novell NET and IPX, etc. 
However, on most PCs, the UMA is crowded with 
hardware ROM BIOSes, shared memory windows, 
and expanded memory frames, and can be complex 
to configure (there will be a future article on 
memory managers). 


DOS 5.0 and PC Network/LAN on the Ungermann- 
Bass TCPBIOS 

All versions of IBM PC Network/LAN using the 
Ungermann-Bass TCPBIOS can run under PC-DOS 5.0 
or MS-DOS 5.0. (Some adjustments are required for 
those combinations that are marked with an asterisk 
[*] in the table below.) This is possible because DOS 
5.0 comes with a copy of the network redirector for 
PC Network/LAN and can fake lower DOS version 
numbers to individual programs. 


PC Net/LAN Version DOS Versions 


IBM PC Network 
IBM PC LAN 


IBM PC LAN 
IBM PC LAN 
IBM PC LAN 


s05 


5.0* 
4.0x 


Different versions of IBM PC Network/LAN on the 
Ungermann-Bass TCPBIOS can interoperate with each 
other no matter what DOS they are running on. 
Consequently a workstation running PC Network 1.0 
on DOS 3.1 can access files on a server running PC 
LAN 1.2 on DOS 3.3, and a clone running PC LAN 1.3 
on MS-DOS 4.0 can access the same server. This 
interoperability applies to the Basic Services (file 
sharing, printer sharing, and messages). Versions 
1.30 and later have Extended Services, which will 


1.2x 
1.30-1.33 
1.34 
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Workstation Bulletin Board 


Latest Anti-virus Software Releases 
For the Macintosh: Mac Anti-virus Release 1.4 
For the PC: PC Anti-virus Release 1.3 
Anti-virus software may be obtained by bringing a 
blank formatted diskette to 264 Evans Hall during 
normal consulting hours (10 a.m. to 12 noon and 2 
to 4 p.m. weekdays). Anti-virus software is also 
available on the file servers described below. 


WSSG File Servers 
Cornucopia — Macintosh software 
Moby — PC, DEC, and Sun software 


Cornucopia is an AppleShare file server in the 
Vanishing Point zone of the campus AppleTalk 
network. Moby (moby.berkeley.edu) is a Sun Net- 
work File System (NFS) server. For information on 
accessing these servers, contact Workstation Con- 
sulting (642-8899 or drmicro at garnet). 


Calendar 


Fri, Dec. 6 
2-4 p.m. 


Novell User Group meeting. Topic: 
NetWare Lite. 262 Evans Hall. 


No December Micronet meeting. 


For information on the Novell User Group, contact 
Laura Kim (642-6411 or Ikim at garnet) or Susan 
Mathews (642-7636 or smathews at garnet). 
Micronet, an organization of campus staff who 
have microcomputer support responsibilities or 
interests, normally meets on the second Tuesday 
of each month from 10 a.m. to 11:45 a.m., but 
there will be no Micronet meeting this December. 
For information on Micronet, contact Gordon 
Adams (642-6630 or gadams at garnet) or Aron 
Roberts (642-5974 or aron at garnet). 


only interoperate with versions that have those ser- 
vices. There is one exception. 

A workstation using the MS-DOS 5.0 Upgrade 
redirector cannot connect to a server running IBM PC 
Network 1.0 no matter what PC Network/LAN ver- 
sion the workstation uses. Attempts to connect 
result in the error message “NET823: Network 
request not accepted.” This problem requires some 
choices for such PC clone users (true blue IBM PCs 
should get the IBM PC-DOS 5.0 Upgrade). The 
choices are: upgrade the server to PC LAN 1.10 or 
later (good but costs money), upgrade the worksta- 
tion to PC LAN 1.34 (free if using PC LAN 1.30-1.33), 
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or get the PC-DOS 5.0 Upgrade instead of the MS- 
DOS 5.0 Upgrade. The later choice is only for 
100% IBM-compatible clones (almost all). Clone 
users will not be able to use IBM QBASIC or the new 
DOS 5.0 Editor because both programs check for the 
IBM Basic BIOS when starting up. 

The ideal solution would be to upgrade to IBM 
PC LAN 1.34 on DOS 5.0 PCs. However cost and 
inconvenience may prohibit this solution unless you 
are already using PC LAN 1.30 to 1.33. Our general 
recommendation for IBM PC Network 1.0 users has 
been to upgrade file servers to IBM PC LAN 1.2 or 
later but retain IBM PC Network 1.0 on the worksta- 
tions. This was primarily to get the server perfor- 
mance improvements. Users requiring higher- 
performance file servers should probably switch to 
Novell NetWare. 

For more detail on adjusting IBM PC 
Network/LAN for DOS 5.0, get the handout Upgrad- 
ing to DOS 5.0 with PC Network 1.0 or PC LAN 1.1x to 
1.2x (MIC 2.4.21), from Workstation Consulting, 264 
Evans Hall, 10 a.m. to 12 noon and 2 to 4 p.m. 
weekdays. For more detail on the IBM PC LAN 1.34 
upgrade, get the handout 1.34 Upgrade for IBM PC 
LAN 1.30 to 1.33 (MIC 2.4.22). 

Please contact Workstation Consulting if you dis- 
cover any problems with PC Network/LAN on DOS 
5.0 (264 Evans Hall, 642-8899, or drmicro at garnet). 
O Greg Small. 


Editor’s note: The following articles are the last in a 
series of articles that began in the Summer and Fall 
1991 issues of the Berkeley Computing Quarterly. 


Electronic Mail on VM/CMS— 
Understanding E-mail Addressing 


Previous CMS electronic mail articles have dealt with 
how to send and receive e-mail. Once you know 
how to use the appropriate CMS commands, you are 
likely to find dealing with e-mail straightforward and 
even fun... until the first time you encounter an 
address that just doesn’t seem to work! 

The purpose of this article is to discuss e-mail 
addresses for Berkeley VM/CMS users: how to read, 
understand, and specify them. It is, of course, 
important to know how to address your outgoing 
mail. But it’s also useful to be able to decipher 
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addresses you didn’t create, in order to help dis- 
cover the cause of mail delivery problems. Only 
general concepts are presented here, but this should 
provide at least a starting point in an area ac- 
knowledged to be unfortunately arcane (especially 
considering the diverse population of electronic mail 
users). 

If you are a VM/CMS user, there are two network 
environments you will be most concerned with: BIT- 
NET and the Internet. They have quite different con- 
cepts of e-mail routing and addressing, so we'll first 
discuss them individually. Then we'll say a few 
words about mail that traverses both networks. 


A Note About E-mail Address Syntax 

and Your CMS Environment 

Address formats generally use the @ character. If 
you find that you are unable to enter this character 
without its being swallowed up by the system, you 
can fix this by making one change to your CMS 
environment. Place the following command in your 
PROFILE EXEC, and you won't have to worry about it 
again: 


cp terminal chardel off 


This suppresses the system’s interpretation of the @ 
as a special line editing character (which is not very 
useful in CMS Display Mode anyway). 

An alternative is to substitute at for @ when you 
type e-mail addresses. However, keep in mind that 
this is a convention on CMS that probably won't 
work on other systems you may be using. 


BITNET 

BITNET (Because It’s Time Network) was established 
in the early 1980s as a means of connecting IBM 
mainframes using standard IBM software and 
ordinary telephone lines. It has evolved since then, 
but still maintains much of its original logical 
structure. Although many BITNET sites now run 
non-IBM systems, they use software that understands 
and implements the IBM protocols on which the 
network is based. 

Individual computer systems that are registered 
on BITNET are called nodes. A BITNET node name 
must be a single, unqualified (containing no dots) 
string of at most eight characters. A user at a BITNET 
node would have an e-mail address of the form 


userid@nodename 


where userid is the user’s logon or mailbox name 
and nodename is the BITNET node name. Only 
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these two components are used to identify the desti- 
nation of a mail parcel within BITNET. 

For example, Berkeley's VM/CMS system has the 
BITNET node name of UCBCMSA. If your login 
account on this system is myname, then your BITNET 
address is 


myname@UCBCMSA 
Often, you will see the form 
userid@nodename.BITNET 


The qualified name to the right of the @ should not 
be confused with an Internet address. Rather, this is 
a special convention that is used when mail must 
move between BITNET and the Internet, and is dis- 
cussed below. 


The Internet 
The Internet is a collection of mutually connected 
networks supporting the same routing protocols, 
called TCP/IP (Transmission Control Protocol/Internet 
Protocol). In this environment, individual computer 
systems are usually known as hosts, which are 
grouped into domains. This hierarchical structure is 
solely administrative; its function is to facilitate the 
maintenance of a consistent addressing scheme. No 
physical or geographical significance is necessarily 
implied by the domain structure of an address. 

An Internet address usually looks like this: 


userid@hostname.subdomain.domain 


(There may be more than one level of subdomain.) 
For example, Berkeley’s VM/CMS system has the 
Internet address of 


cmsa.Berkeley.—EDU 


The hostname portion of the address is cmsa, which 
refers to the individual computer system. This host 
is registered in the subdomain Berkeley, which is 
administered by a local campus authority. The 
Berkeley subdomain in turn is registered with an 
Internet central authority that is responsible for the 
EDU high-level domain. (Domain names are not case 
sensitive; examples appear here as they are conven- 
tionally used, but upper and lower case are inter- 
changeable.) 

A Berkeley VM/CMS user with userid myname 
would have an Internet address of 


myname@cmsa.Berkeley.EDU 
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Addressing CMS Mail to BITNET 
and Internet Recipients 
The current state of e-mail routing technology still 
falls far short of complete standardization. In partic- 
ular, a piece of mail sent from one kind of network 
to another may need special handling to ensure it is 
properly routed. Because our VM/CMS system is 
both a BITNET node and an Internet host, there is an 
addressing convention you should use to help our 
mail-delivery software distinguish between a BITNET 
and an Internet address in cases where there may be 
ambiguity. 

When mailing to a BITNET address, always 
append .BITNET to the unqualified node name. For 
example, 


note friend@alaska.BITNET 


If you use just alaska, your e-mail might be sent to 
the (actual) host alaska.Berkeley.EDU. And if that 
host happens not to be accepting mail at all, several 
days may elapse before you receive a nondelivery 
notice. 

Failure to provide proper name qualification can 
cause confusion because the Internet convention is 
to append the local domain (in our case, 
Berkeley.EDU) to unqualified host names. Yet, our 
CMS system is also on BITNET, where it is quite 
natural and reasonable to assume that an unqualified 
name refers to a BITNET address. 

Our mail-delivery software does make default 
assumptions about how to interpret an unqualified 
host name. But this is based on the particular 
address, so it’s best not to try to second-guess the 
result. If you always use a qualified host name (full 
Internet qualification or .BITNET for BITNET nodes), 
you improve the chances of your mail being 
delivered to its intended destination. 

If you are replying to a BITNET address with PEEK, 
you may discover that the .BITNET does not appear 
in your reply header, because it was not present in 
the original return address. Be on the lookout for 
this and, if necessary, respecify or change the desti- 
nation addresses in your reply, by appending the 
-BITNET to unqualified names. 

When in doubt, you may assume that a return 
address appearing in a mail header is on BITNET if 
the host portion of the address (the part that follows 
the @) is a single-token (i.e., unqualified) name. In 
this case, you should add the .BITNET when you 
reply. (The one exception to this is the node name 
UCBCMSA, which is the system you are on. You may 
omit the node name altogether when addressing 
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another person who is also on the Berkeley VM/CMS 
system). 

It should go without saying that if the address 
you use, although it follows all of the syntactic and 
semantic rules, turns out to be invalid or unreach- 
able, your mail will not be delivered. In most cases, 
you will receive some kind of message informing you 
of what happened (or didn’t happen). 


Gateways 

Because BITNET and the Internet use different rout- 
ing protocols, certain BITNET and Internet hosts exist 
to get mail from one network environment to the 
other. These systems have both a BITNET and an 
Internet address, and are known as gateways. In 
fact, our VM/CMS system acts as a gateway, since it 
forwards BITNET-originated mail (received at node 
UCBCMSA) to the Internet (via its incarnation as 
cmsa.Berkeley.EDU) and vice versa. 


An example of a gateway. One use of gateways is 
to send mail to networks that are not part of either 
BITNET or Internet. Some commercial networks have 
established gateways to allow their internal users to 
be reached from the Internet. 

An example is MCI Mail. There is an Internet 
host, whose address is 


mcimail.COM 
which will forward mail to the MCI network. As an 
Internet user, you would mail to an MCI customer as 


follows: 


è Determine the MCI user’s account name, MCI ID, 
or full user name. 


e Use one of the following forms of address: 


accountname@mcimail.COM 
e.g., JSmith@mcimail.COM 


or 


mci_id@mcimail.COM 
e.g., 4280345@mcimail.COM 


or 


full_user_name@mcimail.COM 
e.g., John_Smith@mcimail.COM 


The person on the MCI end will have corresponding 
procedures for mailing to your Internet address. 
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Be aware that, whenever you mail to someone 
on a commercial network, your correspondent may 
incur charges. This, of course, depends on the poli- 
cies of the other network. 


Complex Addresses 
You may see addresses in your mail headers that 
look like this: 


user%nodename@hostname.subdomain.domain 
or 
user%xxx.yyy.zzz@hostname.subdomain.domain 


This is a format that shows up on the Internet and 
here is how it should be interpreted: 


The host name to the right of the @ represents 
an Internet-registered destination. Everything to 
the left of the @ is considered a user, from the 
point of view of Internet routing. When it 
receives the mail, the Internet host has the 
responsibility of converting the rightmost % to 
an @ and delivering the parcel to the resulting 
address by whatever means are available. This 
mechanism is intended for use in reaching hosts 
that are not Internet-registered, via a host that is 
registered. However, an arbitrary Internet host 
may not have this forwarding capability, so you 
are strongly discouraged from using such 
addresses in your own mail. 


This format is not an Internet standard and its use 
often results in unintended routing consequences. 

A site that wishes to be reachable from the Internet 
is encouraged to register a domain address, so it may 
participate fully in the Internet routing process. Or, 
as in the case of MCI Mail, it should register an Inter- 
net gateway, which will forward mail to it. 

However, this address form continues to appear 
in mail headers because it is generated by the mail- 
forwarding software that runs on gateways. Let's 
look at an example. 

Suppose a user at BITNET node YALEVM sends 
you a piece of mail via the Internet. The parcel 
would leave YALEVM, pass through a Yale gateway 
that sends BITNET traffic onto the Internet, arrive at 
cmsa.Berkeley.EDU and be delivered to your 
VM/CMS reader. The return address in the header 
may contain the following: 


From: yaleuser%YALEVM.BITNET@yalevm.ycc.yale.edu 
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The gateway mail-forwarding software at Yale took 
the original return address of yaleuser@YALEVM and 
turned it into the above. The gateway has assumed 
that because you are on the Internet, you may be 
able to reply only to Internet addresses. So, it has 
given you a return address that is routed through 
Yale’s Internet/BITNET gateway, where your reply 
would be forwarded to Yale’s BITNET address. 

Just remember that the % notation is mostly for 
use by gateways and should not be relied upon by 
individuals who are originating mail. It will continue 
to be used, no doubt, as long as there are networks 
(like BITNET) having address spaces incompatible 
with the Internet’s. But you, as an ordinary sender 
of mail, should leave the details of internetwork rout- 
ing to the gateways. 


Summary 

With the increasing interconnectivity of computer 
mail networks around the world has come greater 
complexity in addressing. This is a developing tech- 
nology, and it is hoped that more standard and 
user-friendly mechanisms eventually will become 
available. 

Meanwhile, at Berkeley, if you have a problem 
with a particular piece of e-mail that involves deliver- 
ability or addressibility, you may contact the IST 
Postmaster for assistance at 


postmaster@mailhost.Berkeley.EDU 


O Mike Friedman. 


E-mail Troubleshooting on CMS 


Just as in the case of U.S. mail, there may be rare 
times when electronic mail delivery problems occur. 
Sometimes the e-mail may be improperly addressed, 
and it is returned to the sender. Or the addressee 
cannot be reached for many days, so the mail is 
returned. Sometimes e-mail is delayed in delivery 
because the route has experienced a breakdown. 
Most of the time, once the mail is sent, it is 
delivered as soon as possible. But when it does not 
get delivered or there is a delay, the returned mail 
provides clues to the problem. 


Terminology 
To comprehend troubleshooting techniques, the ter- 
minology for various software functions and e-mail 
components must be understood. 

Mail User Agent (MUA) is any program used by a 
' person to generate e-mail. These include NOTE and 
PROFS on CMSA. 
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Mail Transport Agent (MTA) is any server software 
that actually passes the e-mail along to the appropri- 


ate computer nodes or handles the delivery to local 


users. 

BSMTP is a Batch Simple Mail Transfer Protocol 
envelope containing delivery instructions to a mail 
transport agent. The mail user agent automatically 
generates the envelope containing “HELO”, “MAIL 
FROM:”, “RCPT TO:”, “DATA”, and “QUIT” lines 
when the e-mail is sent. 

Header is the addressing inside the e-mail includ- 
ing the “To:”, “From:’”, “Date:”, and “Subject:”’ 
lines. Other lines may be included if the mail has 
been forwarded, resent, or has specified an alterna- 
tive reply address. You see the header upon enter- 
ing the NOTE command. 

Received: lines are lines added to the e-mail as it 
passes through mail transport agents to provide net- 
work tracking information. They are part of the 
header. 

RSCS is a software server that transmits data files 
(including e-mail files from mail transport agents) 
across BITNET. 


General Mail Processing 

You generate e-mail using a mail user agent. Once 
you send the mail, NOTE decides which mail 
transport agent is most appropriate. If the mail is 
destined to another CMSA user, NOTE may deliver 
the mail directly, acting as the mail transport agent. 
If the mail is destined for nodes that have mail 
transport agents, the e-mail is put into a BSMTP 
envelope and handed to one of CMSA’s mail 
transport agents. Currently, if the mail is destined 
for the Internet locally, the e-mail is handed to a 
server named SMTPMX. If the mail is destined for 
BITNET or some domain other than .Berkeley.EDU, 
then it is handed to a server named MAILER, which 
reads the envelope and transmits the e-mail 
according to the destination’s mail transport agent 
type. Otherwise, if the destination does not have a 
mail transport agent, the e-mail is tagged for an RSCS 
destination and is transmitted by a server named 
NET. 


Reading Mail Notifications and Problem 
Determination 

If there is a problem with e-mail delivery, the mail 
transport agent returns a notification of the problem 
to the sender. The notification may contain error 
responses to the BSMTP envelope, or it may contain 
the entire BSMTP dialog of the envelope and 
responses, as well as errors. The original e-mail 
message is normally enclosed. 
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Date: Wed, 18 Sep 91 14:11:43 PDT 
From: <SMTPMX@cmsa.Berkeley.EDU> 
To: <SNEEZY@CMSA. BERKELEY . EDU> 
Subject: Undeliverable Mail 


<grumpy@hovel .Berkeley .EDU> 
cmsa.Berkeley.EDU received negative reply: 
550 <grumpyGhovel.Berkeley.EDU>... 


** Text of Mail follows ** 


Date: Wed, 18 Sep 91 14:11 PDT 

From: SNEEZY@cmsa.Berkeley.EDU (S. Dwarf) 
Subject: e-mail demo of bounced mail 

To: grumpy@hovel.Berkeley.Edu 


Hi, 
I’m just doing a demo of e-mail. 


S. 


Figure 1: Example of notification mail. 


The notification mail will come to your reader, 
and it may appear to be sent from such userids as 
DAEMON or MAILER-D or MAILER. Since these mail 
transport agents are from other computer nodes, 
there are no strict rules about the userids used. For 
CMSA, local notification messages usually come from 
MAILER or SMTPMX or 


MAILER-D@mailhost.Berkeley.EDU 


It may be as simple as the message in Figure 1. 
Note the first section is the header where the From 
line identifies the mail transport agent that generated 
the notice. The next section contains the error con- 
ditions. The 550 message means that the userid 
grumpy is unknown at computer node 
hovel.Berkeley.EDU. This suggests an addressing 
problem. Perhaps the correct address is 
grumpy@cottage.Berkeley.EDU or 
grumpie@hovel.Berkeley.EDU. In any case, you 
should verify the correct spelling and destination 
address and resend the mail. 

Note that 550 is a reply failure message, and the 
actual message text can vary greatly. Common mes- 
sage text variants include: 


User unknown 


I still have that hay fever. 
Best regards, 
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cmsa.Berkeley.EDU unable to deliver following mail to recipient(s): 


Received: from CMSA.BERKELEY.EDU by cmsa.Berkeley.EDU (IBM VM SMTP R1.2.2MX) 
with BSMTP id 9799; Wed, 18 Sep 91 14:11:37 PDT 


e “User Unknown”, meaning the user does not 
exist on the node. Variations include “Not a 
local user”, “Mailbox not found”, and 
“Requested action not taken: mailbox unavail- 
able”. 


e “Host Unknown”, meaning the computer node 
is not locally known. 


Any 550 message suggests an addressing problem. 
The most common reason for this message is a 
nonexistent userid. If you have sent mail and 
received replies from the address previously and 
now you get 550 notifications, it is most likely that 
the userid has been canceled. If you get Host 
Unknown messages, check for typos or completely 
specify the domain of the node so that it is sent to 
the correct network. 

Finally, notice that the original message was 
included in the returned mail. The Received line 
was added to the original message of SMTPMX, indi- 
cating the originating mail was from CMSA and 
received by CMSA. The software used is indicated in 
parentheses, and the appropriate date/time informa- 
tion is wrapped onto the next line. In the simple 
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1879; Fri, 20 Sep 91 07:57:21 PDT 


7804; Fri, 20 Sep 91 09:59:42 CST 
Date: Fri, 20 Sep 91 09:59:41 CST 
From: Network Mailer <MAILER@TTUVM1 .TTU.EDU> 
To: SPGBRG@CMSA. BERKELEY . EDU 
Subject: mail delivery error 


Batch SMTP transaction log follows: 


050 HELO UCBCMSA.BITNET 

250 TTUVM1.TTU.EDU Hello UCBCMSA.BITNET 

050 TICK 1875 

250 1875 ... that’s the ticket. 

O50 MAIL FROM: <SPGBRG@CMSA . BERKELEY . EDU> 

250 <SPGBRG@CMSA.BERKELEY.EDU>... sender OK. 
050 RCPT TO: <WCENTER-L@TTUVM1 . BITNET> 

250 <WCENTER-L@TTUVM1.BITNET>... recipient OK. 
050 DATA 

354 Start mail input. End with <crlf>.<crlf> 


554 ’WCENTER-...’ is too long to be a VM userid. 
050 QUIT 


Original message follows: 


7803; Fri, 20 Sep 91 09:59:41 CST 


BSMTP id 1875; Fri, 20 Sep 91 07:56:38 PDT 
Date: Fri, 20 Sep 91 07:56 PDT 

From: SPGBRG@UCBCMSA 

Subject: testing 
To: WCENTER-L@TTUVM1 


This is a test. 
mail delivery error 


Received: from TIUVM1.TTU.EDU by UCBCMSA.BITNET (Mailer R2.04) with BSMTP id 


220 TIUVM1.TTU.EDU Columbia MAILER R2.07 BSMTP service ready. 


554-Mail not delivered to some or all recipients: 


221 TTUVM1.TTU.EDU Columbia MAILER BSMTP service done. 


Received: from UCBCMSA.BITNET by TTUVM1.TTU.EDU (Mailer R2.07) with BSMTP id 


Received: from CMSA.BERKELEY.EDU (SPGBRG) by UCBCMSA.BITNET (Mailer R2.04) with 
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Received: from TTUVM1.TTU.EDU by TTUVM1.TTU.EDU (Mailer R2.07) with BSMTP id 


Figure 2: The mail transport agent including the BSMTP envelope information. 


case where the mail never left the originator’s node, 
this is purely informational. 

Delayed delivery notices are often of the same 
simple format. Mail transport agents send 
notifications when mail is undeliverable, because the 
destination node is unavailable due to a system or 
network link being down. This failed delivery mes- 
sage takes the form “Unable to deliver mail for... 3 


days”, where the number of days may vary, depend- 
ing on the sending mail transport agent. You should 
check the address to verify that it is the correct, fully 
qualified address, because it may be addressed to 
the wrong network. (See “Understanding E-mail 
Addressing” in this issue.) If the address is correct, 
resend the mail. 
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In the Figure 2 example, the mail transport agent 
includes the BSMTP envelope information with its 
undeliverable mail notifications. 

You will notice several differences. First, the 
notification header has two Received lines. When 
there are multiple Received lines, they are read from 
bottom to top. This notification was generated on 
TTUVM1.TTU.EDU and sent to their Mailer software, 
as shown by the bottom Received line. The line 
above it shows that Mailer software running on 
UCBCMSA.BITNET received it from TTUVM1.TTU.EDU. 

The next section of the notification parcel 
includes the entire envelope of the original mail, line 
by line, and the responses and errors given for each. 
The envelope lines are indicated by the 050. Note 
that the 554 error message attempts to be specific 
about the problem, which is that the userid is too 
long. 

The original mail is included along with all the 
Received lines to indicate the network path taken. 
This information can be useful to e-mail administra- 
tors in determining precisely where on the network a 
problem may have occurred. 


Reporting Problems 

If you experience a problem you cannot resolve, 

contact a consultant at 642-4072 or send e-mail to 
consult@cmsa 

If you need further assistance with figuring out 

appropriate addressing to reach a particular node, 

contact 


postmaster@mailhost.Berkeley.EDU 


O Bonnie Giagnacova. 


Plotcgm: Plotting ISO CGMs on the 
Color Electrostatic Plotter 


The Graphtec Precision Image color electrostatic 
plotter in the basement of Evans Hall can now pro- 
duce both monochrome and color plots. It had pre- 
viously produced only monochrome plots. 

The plotter has a 400 dot-per-inch resolution and 
produces durable, fade-resistant pictures in more 
than 64 thousand colors using black, cyan, magenta, 
and yellow toners. This plotter is attached to CMSA 
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and prints ISO Standard Computer Graphics 
Metafiles (CGMs) via the new plotcgm command. 

The ISO Standard Computer Graphics Metafile* is 
a file for storing and transferring the description of a 
two-dimensional, static, color picture (or pictures). A 
CGM can include such elements as lines, markers, 
text, filled areas, and cell arrays (raster images). 
CGMs come in three “flavors” (encodings): binary, 
character, and clear text. These encodings contain 
identical information in a system-independent, 
device-independent manner. Pictures stored as 
CGMs are also portable across graphics software from 
multiple vendors. For instance, a mechanical draw- 
ing generated on a mainframe can be read into a 
graphic arts program on a microcomputer for aug- 
mentation, and then imported into a desktop pub- 
lishing system on a workstation. 

The new plotcgm command on CMSA plots any 
of the three encodings of ISO Standard CGMs on the 
color electrostatic plotter. Plotcgm first checks your 
file to determine if it is probably an ISO CGM. It 
then reports its encoding to you and sends the file to 
the plotter. The plotter uses 2-foot by 3-foot (“D” 
size) sheets of paper, and places more than one pic- 
ture from a single job on a sheet, if possible. Plot 
jobs or pictures that need more than one sheet of 
paper are continued automatically on successive 
sheets of paper. As soon as your job is queued to 
the plotter, electronic mail is sent to your account 
describing the results of the job. After your queued 
job has been processed, you can pick up your plot 
from the long plotboxes in the 1/O area in the base- 
ment of Evans Hall. A banner with your login name, 
the date, and other information is always the first 
“picture” plotted. 

The best results are obtained from the plotter 
when fully saturated colors are confined to small 
areas or narrow lines. Use pastel (desaturated) 
colors for larger areas. Note that the colors on color 
terminals often looks different from printed colors. 

There are software products currently supported 
by Central Computing Services (CCS) and the Work- 
station Software Support Group (WSSG) that generate 
ISO CGMs. On CMSA, for example, DISSPLA currently 
does so, as will the next version of TELLAGRAF. If 
you are using NCAR Graphics from WSSG’s file server 
Moby, you can generate a CGM from NCAR Graphics 
metacode using the ncgm2cgm command. 


* The American National Standards Institute has replaced 
the ANSI CGM Standard (ANSI X3.122-1986) with its identical 
International Standards Organization version (ISO 8632- 
1987). 


November-December 1991 


University of California 
Volume 1, Number 1 


at Berkeley 


You can transfer CGMs generated on other com- 
puters to your account on CMSA using either ftp or 
kermit, You can then send your file to the plotter 
with the plotcgm command. If your CGM is binary 
or character encoded, you must use binary mode to 
transfer the file. For the clear text encoding, you 
must use the normal ASCII transfer mode. Most 
software packages generate binary-encoded CGMs. 
If you wish to open a CMSA account, contact User 
Account Services in 241 Evans Hall or call 642-7355. 

The ISO CGM is a non-proprietary, public, pic- 
ture storage format. However, not all vendors of 
CGM software adhere to the Standard, and such files 
will not print properly on devices that support the 
ISO CGM (such as our color electrostatic plotter). 
Vendors of software that conforms to the Standard 
include: Computer Associates, Computer Support 
Corp., Genigraphics, GTX Corp., Software Publishing 
Corp., Larsen Software Technology, Cadam, National 
Center for Atmospheric Research, Pansophic Sys- 
tems, Precision Visuals, and Zenographics. If your 
workstation or mainframe software generates a CGM 
but you are unsure whether it conforms to the ISO 
Standard, please contact me at 642-1789 or 
primbsch at cmsa. | can help you test your file for 
conformance. | may also be able to help you find a 
path from whatever non-CGM file format your 
software generates to the ISO Standard CGM. 

For information on using plotcgm, type help 
plotcgm on CMSA. If you are using NCAR Graphics 
from WSSG’s file server Moby, type man ncgm2cgm 
to see how to convert an NCAR Graphics metacode 
file into a CGM. 

For more information on the ISO CGM Standard, 
see ANSI/ISO 8632.4 1991, Computer Graphics 
Metafile, American National Standards Institute, New 
York; CGM and CGI, D. B. Arnold and P. R. Bono, 
Springer-Verlag, 1987; or The Computer Graphics 
Metafile, L. R. Henderson and A. M. Mumford, 
Butterworth & Co., 1990. 

To see a picture of the Graphtec Precision Image 
plotter and a sample of its output, visit the display 
case opposite 215 Evans Hall. 

On CMSA, DISSPLA users are encouraged to 
begin generating CGMs instead of plotfiles, and use 
the plotegm command instead of the versatec com- 
mand, See the VMNEWS topic DISSPLA for details. 
Type help vmnews to see how to use VMNEWS. For 
instructions on generating a CGM with DISSPLA, type 
help disspla, and see the September 1990 version of 
the local document DISSPLA Under CMS: A 
Programmer's Guide (IBM 7.3.3). O 
Sharon Primbsch . 
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